📋 Description

This pull request introduces comprehensive documentation for using Blocks within the Rich Text Editor in Umbraco CMS, clarifies configuration and rendering references, and improves guidance for creating custom views for Blocks. The most significant changes are the addition of a detailed guide for Blocks in the Rich Text Editor, updates to broken documentation links, and expanded instructions for custom block views.

Documentation enhancements for Blocks in Rich Text Editor

• Reinstates blocks.md found in v15, detailing how to configure, set up, and render Blocks within the Rich Text Editor
• Updates the screenshots referenced in the article
• Updates the information relayed

Reference and link corrections

• Updated references to the Blocks documentation in configuration.md and macros.md to point to the new blocks.md guide, replacing broken links. [1] [2]

Improvements to custom view registration for Blocks

• Clarified that the forBlockEditor parameter accepts arrays and can target multiple block editors, including block-list, block-grid, and block-rte, with explanations for each.

📎 Related Issues (if applicable)

✅ Contributor Checklist

I've followed the Umbraco Documentation Style Guide and can confirm that:

• Code blocks are correctly formatted.
• Sentences are short and clear (preferably under 25 words).
• Passive voice and first-person language (“we”, “I”) are avoided.
• Relevant pages are linked.
• All links work and point to the correct resources.
• Screenshots or diagrams are included if useful.
• Any code examples or instructions have been tested.
• Typos, broken links, and broken images are fixed.

Product & Version (if relevant)

CMS 16

Deadline (if relevant)

ASAP

📚 Helpful Resources

• 🧾 Umbraco Contribution Guidelines
• ✍️ Umbraco Documentation Style Guide